Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Getting and Playing Movies / Controlling Movie Playback

GoToEndOfMovie

The GoToEndOfMovie function repositions a movie to play from its end.

pascal void GoToEndOfMovie (Movie theMovie);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

DESCRIPTION

If you have defined an active movie segment, the GoToEndOfMovie function repositions the movie to the end of the active segment. If the movie is in preview mode, the function goes to the end of the preview segment of the movie. In all other cases, this function moves you to the end of the movie.

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid

SEE ALSO

You can use the SetMovieActiveSegment and GetMovieActiveSegment functions to work with the active segment. For details, see "Enhancing Movie Playback Performance" beginning on page 2-119.